home *** CD-ROM | disk | FTP | other *** search
/ Gold Medal Software 3 / Gold Medal Software - Volume 3 (Gold Medal) (1994).iso / utils1 / 4dpatch.arj / PATCH.DOC next >
Text File  |  1993-11-23  |  4KB  |  91 lines
  1.                                JP Software
  2.  
  3.                        Patch Program Documentation
  4.  
  5.  
  6. Copyright 1988 - 1993, JP Software Inc., All Rights Reserved.  Published
  7. by JP Software Inc., P.O. Box 1470, E. Arlington, MA 02174 USA, (617)
  8. 646-3975.
  9.  
  10.  
  11. This file explains briefly how the JP Software patch program PATCH.EXE
  12. works and how to use it.
  13.  
  14. The patch program cannot be used by itself -- you must also have a patch
  15. file.  The patch program is provided separately so you can download it
  16. once, then use it with individual patch files when they are issued,
  17. without having to download another copy of the patch program with each
  18. patch file.
  19.  
  20. The patch program converts one or more old 4DOS, 4OS2, or 4DOS/NT files
  21. to the most recent version.  It is part of the .RTPatch software update
  22. package from PocketSoft Inc. (see below).  JP Software uses .RTPatch to
  23. generate "patch" files which contain the differences between the old and
  24. new versions of one or more of our files.  You then apply these patches
  25. to your copy of 4DOS, 4OS2, or 4DOS/NT to update it to the latest
  26. version.  The patches are usually much smaller than the new file, so
  27. this approach saves download time.
  28.  
  29. A typical patch will include a patch file with the extension .RTP, and a
  30. documentation file with the extension .DOC.  The documentation file with
  31. each patch explains the details for that patch, but in general a patch
  32. is applied in three steps:
  33.  
  34.        (1) Collect the files to be patched and the patch (.RTP) file
  35.        into a single directory.  The patch will not work unless all
  36.        files are in the same directory.  The PATCH.EXE program should be
  37.        in that directory as well, or located in a directory on your
  38.        PATH.
  39.  
  40.        (2) Change to the new directory.
  41.  
  42.        (3) Enter the command:
  43.  
  44.                  PATCH [patchname]
  45.  
  46.        where [patchname] is the name of the .RTP file (without the
  47.        extension or the square brackets).  Note that a "." is required
  48.        between the PATCH command and [patchname].
  49.  
  50.  
  51. There are a few additional things you should be aware of when running
  52. PATCH:
  53.  
  54.    **  You can only patch the original file for which the patch was
  55.        generated.  If any of the files to be patched has been modified
  56.        in any way since you received it from JP Software, or is not the
  57.        exact version for which the patch was created, then that file
  58.        will not be patched.  For example, if you edit a documentation
  59.        file or an icon, or compress an executable file with PKLITE or
  60.        DIET, then PATCH will not update the file.  This is a safety
  61.        feature which prevents PATCH from modifying the wrong version of
  62.        a file.  The exception is 4DOS and 4OS2 BRANDing:  our patch
  63.        files are constructed to handle the changes created by the BRAND
  64.        program, and to automatically transfer the brand from your old
  65.        4DOS or 4OS2 executable file to the new file.
  66.  
  67.    **  PATCH will ignore missing files.  If the patch you are installing
  68.        is for multiple files and only some files are present, only those
  69.        files will be updated.  You can copy additional files later and
  70.        rerun the PATCH command to update them; this will cause some
  71.        harmless messages when PATCH finds some of the files have already
  72.        been patched.
  73.  
  74.    **  PATCH can be run from DOS, from an OS/2 DOS session, or from an
  75.        OS/2 protected-mode session under 4OS2.EXE or CMD.EXE.  Do not
  76.        use PATCH to update executable files like 4OS2.EXE from an OS/2
  77.        protected-mode session while the program to be updated is
  78.        running.  OS/2 does not allow executable files to be modified
  79.        while they are in use, so PATCH will not be able to update the
  80.        file.  Instead, end the program before applying the patch.  If
  81.        you prefer you can copy the file to another directory, apply the
  82.        patch there, and then either end the program and copy the
  83.        modified file back to the original location, or reconfigure your
  84.        system to use the modified file in the new directory.
  85.  
  86.  
  87. [PATCH.EXE is a copyrighted program, distributed under license to JP
  88. Software.  For more information on the complete .RTPatch software update
  89. package contact PocketSoft, Inc., P.O. Box 821409, Houston, TX 77282,
  90. USA, phone 713-460-5600, fax 713-460-2651.  .RTPatch is a trademark of
  91. PocketSoft Inc.]